home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir26 / otview.zip / OTVIEW.DOC < prev    next >
Text File  |  1993-10-22  |  39KB  |  768 lines

  1.  
  2.                      OTVIEW
  3.                    Version 3.1
  4.                     
  5.                         Merritt Island Technlogies
  6.                       253 Merritt Square, Suite 616
  7.                          Merritt Island, FL 32952
  8.  
  9.                            Voice: (407)690-3500
  10.                           BBS/FAX: (407)459-0969
  11.  
  12.  
  13.       CONTENTS
  14.  
  15. 1    Disclaimer
  16. 2    Overview
  17. 3    Hardware Requirements
  18. 4    Installation and Configuration
  19. 5    Connecting the ONE TOUCH II to Your Computer
  20. 6    Navigating the OTVIEW Menus
  21. 7    Main Menu
  22. 7.1  View/Change ONE TOUCH Settings
  23. 7.2  Download ONE TOUCH Data
  24. 7.3  Read Stored ONE TOUCH Data
  25. 7.4  Clear ONE TOUCH Memory
  26. 7.5  Update Patient Name
  27. 7.6  Exit Program
  28. 8    Display ONE TOUCH Data Menu
  29. 8.1  Display ONE TOUCH Data
  30. 8.2  Print ONE TOUCH Data
  31. 8.3  Plot ONE TOUCH Data
  32. 8.4  Save ONE TOUCH Data to Disk
  33. 8.5  Append ONE TOUCH Data
  34. 8.6  Return to Main Menu
  35. 9    Troubleshooting
  36. 10   Copyright Information
  37. 11   Sample Output
  38.  
  39.  
  40. 1     DISCLAIMER
  41.  
  42. OTVIEW is a tool to allow access to the various capabilities and data
  43. normally made available to the ONE TOUCH II Blood Glucose Meter user
  44. by the Manufacturer. Among these is the capability to change the
  45. meter operating parameters, retrieve stored blood glucose readings,
  46. and to completely purge the internal memory. OTVIEW will allow you to
  47. take control of these same functions available to all OT II users,
  48. but through the convenience of a computer and keyboard interface. As
  49. with any tool of this type, It is NOT to be used as a Diagnostic
  50. tool, nor be used as an indicator of any need to modify a treatment
  51. regimen.  ONLY you and your Doctor should ever modify your medication
  52. dosages and schedules.
  53.  
  54.  
  55. 2    OVERVIEW
  56.  
  57. OTVIEW is a small and simple yet powerful tool designed to let you
  58. control the operation of and retrieve data from the ONE TOUCH II
  59. blood glucose meter manufactured by LifeScan, Inc.  It will allow you
  60. to display and modify any of the meter's operating parameters, clear
  61. the internal memory, and to download, annotate, print, plot, and
  62. store readings from the meter.  Details on how to perform each of
  63. these functions is described in the following text.  This program has
  64. evolved from over two years of development and testing, and we have
  65. included many features and improvements suggested by a variety of
  66. people who used this program daily over a long period of time.  We
  67. are indebted to everyone who has made inputs to help make OTVIEW a
  68. better program, and feel we have produced an extremely useful, high
  69. quality product that will greatly enhance both the use of the ONE
  70. TOUCH II meter, and the recording and analysis of blood glucose
  71. levels.
  72.  
  73. As always, we welcome any questions, comments, suggestions, and
  74. complaints from anyone who uses this program on a regular basis and
  75. has ideas on how to make it better.  Tom McKeever and Mike Peacock
  76. can be reached at the SPACECON BBS (1:374/22, 94:4070/1, or
  77. 150:401/8) at (407) 459-0969 at any time.  Phone messages may be left
  78. at our voice mailbox at (407) 690-3500, and E-Mail may be sent to
  79. Tom.McKeever@TECHTALK.COM.
  80.  
  81. This program was created using Turbo C by Borland, and makes
  82. extensive use of the C Extended Libraries (CXL) (c) by Mike Smedley.
  83.  
  84. Please note that due to significant changes in the file formats
  85. beginning with version 3.0, this edition of OTVIEW cannot be used
  86. with data files created under OTVIEW versions 2.x or earlier.   
  87.  
  88.  
  89. 3    HARDWARE REQUIREMENTS
  90.  
  91. OTVIEW is meant to run on an IBM PC or fully compatible clone running
  92. DOS 2.1 or later, and a having little over 200 K of available memory.
  93. It is for reasons of memory and disk space conservation that OTVIEW
  94. was written for DOS. A Windows version can be made available, but
  95. uses up to 10 times the hard drive space and considerably more
  96. memory.  Windows is therefore not required, although OTVIEW will run
  97. under it.. OTVIEW is small enough to run from a floppy diskette, on a
  98. laptop computer, or can be installed on your hard drive. OTVIEW fully
  99. supports Microsoft Mouse compatible pointing devices, and if one is
  100. detected during startup, it may be used to navigate the various menus
  101. and displays.  If you wish to use the data graphing function, then an
  102. EGA or VGA type graphics adapter with appropriate monitor is
  103. required.
  104.  
  105. Access to a spare serial (COM) port is also necessary, however a
  106. dedicated port is not necessary since it will only be needed for
  107. brief periods when you are actually displaying or modifying operating
  108. parameters or downloading data.  Most modern computers have at least
  109. two serial ports, one of which is usually connected to a mouse, and
  110. the other to a modem.  Many users we have talked to simply unplug
  111. their modem temporarily to connect the ONE TOUCH meter.  If this
  112. becomes inconvenient, serial A-B switch boxes are available from most
  113. computer supply stores (or from us) so you won't have to connect and
  114. disconnect cables.  A special cable, (Available from free of charge
  115. from Johnson and Johnson at 1-800-227-8862) is needed to connect the
  116. ONE TOUCH II to your Computer's Serial (COM) port. This cable has
  117. been available at no charge to registered ONE TOUCH II users, and is
  118. terminated with a 25 pin male connector.  If your computer requires a
  119. female and/or a 9 pin connectors, adapters and gender changers are
  120. also available at most computer supply stores, or may be purchased
  121. from us at the same time you order your registered version of OTVIEW.
  122.  
  123.  
  124. 4    INSTALLATION AND CONFIGURATION
  125.  
  126. OTVIEW may be run from either a floppy diskette, or a hard disk drive
  127. by simply copying the files to the appropriate subdirectory.  Note
  128. that the only file required to use OTVIEW is the executable file
  129. itself, no other driver or configuration files are needed.  OTVIEW
  130. may be run from any subdirectory in your DOS 'PATH' string, however
  131. it is necessary to set your default directory to wherever you wish
  132. data files to be saved to or loaded from prior to starting the
  133. program (this version does not allow directory paths to be specified
  134. for data file names).  The simplest approach is to make a separate
  135. subdirectory to contain all program, documentation, and data files.
  136.  
  137. The only parameter that needs to be configured for OTVIEW is the
  138. patient name.  Start the program, and at the main menu select 'Update
  139. Patient name'.  Enter the name of the person who the readings are
  140. taken from, and press 'Enter' to save.  The use of this parameter is
  141. more fully described below.  
  142.  
  143.  
  144. 5    CONNECTION OF ONE TOUCH II TO YOUR COMPUTER
  145.  
  146. Setting up OTVIEW with your ONE TOUCH II is quite easy. 
  147.  
  148.     1. Connect the Serial cable to an available serial port on your
  149.        computer.  (Your Computer and the ONE TOUCH II should both 
  150.            be off.)
  151.     2  Plug in the other end to the receptacle on the ONE TOUCH II Meter.
  152.     3. Turn on your Computer and log to the directory where OTVIEW
  153.        resides. (e.g. cd\OT3) 
  154.     4. Type OTVIEW and hit the ENTER key.  
  155.     5. Read the Opening Screen and hit ENTER to continue, or Escape 
  156.        to exit.  
  157.     6. If you wish to display/modify your ONE TOUCH operating parameters 
  158.        or download stored readings, turn on the ONE TOUCH II and verify 
  159.        that it is flashing 'INSERT STRIP'
  160.  
  161.  
  162. 6    NAVIGATING THE OTVIEW MENUS
  163.  
  164. Moving around within the OTVIEW menus can be done by any of three
  165. methods.  The program fully supports most mouse type pointing
  166. devices.  On menus and submenus where a list of options is displayed,
  167. move the mouse to highlight the entry desired.  The left mouse button
  168. simulates the 'Enter' key to select the highlighted option, and the
  169. right button simulates the 'Escape' key used to abort an operation
  170. and return to the previous menu level.  Each of the menu entries has
  171. a letter (usually the first) capitalized and highlighted.  A specific
  172. option can be selected and activated by simply pressing the same key
  173. on the keyboard.  Also, entries may be selected by using the keyboard
  174. cursor keys, and selected by pressing 'Enter' or aborting the
  175. operation by pressing 'Escape'.  A blinking cursor is displayed when
  176. keyboard input is expected from the user, for example in specifying
  177. patient names or file names, or entering comments in the data display
  178. screen.
  179.  
  180.     
  181. 7    THE 'MAIN' MENU
  182.  
  183.     The Main Menu gives you the following choices:
  184.  
  185.              "View/change ONE TOUCH settings"
  186.             "Download ONE TOUCH data"
  187.             "Read stored ONE TOUCH data"
  188.             "Clear ONE TOUCH memory"
  189.             "Update patient name"
  190.             "eXit program"
  191.  
  192.     (Note that the "hot-Keys" are capitalized and highlighted)
  193.  
  194. Selecting either the 'View', 'Download', or 'Clear' options requires
  195. communications with the ONE TOUCH and will bring up a submenu asking
  196. for the COM port number to which the device is connected.  The menu
  197. will display an entry for all serial ports detected by the program,
  198. and will give an error if it sees that none are present.  Turn on the
  199. ONE TOUCH and verify that it is flashing 'INSERT STRIP'.  Within
  200. about twenty seconds the program should display a message showing
  201. that communications has been established and the current baud rate.
  202. If this does not work or an error message is displayed, then refer to
  203. the later section on 'Troubleshooting'.
  204.  
  205.  
  206. 7.1    VIEW/CHANGE ONE TOUCH SETTINGS
  207.  
  208. When communications have been established, the screen showing current
  209. values for the changeable operating parameters will be presented.
  210. Any of these parameters can be changed by either selecting the
  211. capitalized/highlighted letter and hitting Enter, or selecting it
  212. with the mouse. A list of available selections will then be
  213. displayed. Scroll to the setting you wish to change to with the arrow
  214. keys or the mouse, or, in the case of numerical values such as time
  215. or dates, to the number to be entered/replaced. Hit Enter when
  216. satisfied.  When a new value has been chosen, the meter will be
  217. updated immediately and the new selected value should then be
  218. displayed on the screen.  A brief description of each of these
  219. parameters and available options is described below:
  220.  
  221. WARNING: BE CAREFUL OF WHAT YOU DO HERE.. THESE SETTINGS CAN BE SET
  222. TO GIVE  YOU TOTALLY INACCURATE READINGS AND DATA DUMPS.. USE WITH
  223. CAUTION !
  224.  
  225.  
  226. Strip Code : This parameter is a number between 1 and 16 and should
  227. be set according to the  value shown on the box of test strips that
  228. you are using.
  229.  
  230. Language : The ONE TOUCH II is capable of displaying prompts and
  231. messages in seven  languages.  In order to keep the size and
  232. complexity of OTVIEW reasonable, the program communicates with the
  233. device only in English.  If you are using any other language, the
  234. program will display it as the active value, but will switch the
  235. meter to English when bringing up this screen.  If a value other than
  236. English is selected, it will be displayed on the menu, but the ONE
  237. TOUCH II prompts will not change to  the desired language until this
  238. screen is exited.  Similarly, when a memory dump is requested, OTVIEW
  239. will change the meter to English before downloading the data, then
  240. change it back to the selected language when complete.
  241.  
  242. Units: Used to select the units of measure, either milligrams per
  243. deciliter (MG/DL), or millimoles per liter (MMOL/L).
  244.  
  245. Beep: Select 'BEEP' if you wish the meter to beep after each function
  246. or when a new message is displayed, or 'NOBEEP' it you want it to be
  247. silent.
  248.  
  249. Punctuation: If you have selected MMOL/L as your units, then this
  250. option may be used to specify whether a decimal point or a comma is
  251. to appear in the value for each reading.
  252.  
  253. Date Format: Tells the meter if you want dates displayed as
  254. month/day/year (M/D/Y), or as day/month/year (D/M/Y).
  255.  
  256. Time Format: Tells the meter if you want time displayed in 12 hour
  257. AM/PM type format (AM/PM),  or as 24 hour format (24:00).
  258.  
  259. Date: The current date from the meter will be displayed according to
  260. the currently  selected date format.  You may also select and modify
  261. the month, day, or year.
  262.  
  263. Time: The time from the meter's clock will be continually read and
  264. displayed on the  screen per the currently selected time format.  You
  265. may set the time in the meter  by selecting either hours, minutes, or
  266. seconds.
  267.  
  268. Day: The day of the week as calculated from the date in the meter is
  269. shown.  This value  may not be modified, and hopefully matches what
  270. the day really is !
  271.  
  272.  
  273. Baud: Used to select the speed with which the meter will talk to your
  274. computer.  The available options are 9600, 2400, 1200, and 300 bits
  275. per second.  Most modern computers will support communications at the
  276. highest rate, so you should normally use the 9600 value.  If you
  277. start having time-out or checksum errors while using OTVIEW, you
  278. might try using a lower speed and see if it helps, although this will
  279. slow down the operation of the program.  For example, downloading 250
  280. readings from the meter takes only about 15 seconds at 9600 baud, but
  281. would require 1 minute at 2400, 2 minutes at 1200, and 8 minutes at
  282. 300 baud !  Note also that although the baud rate will be updated as
  283. soon as a new value is selected, the communications rate will not
  284. change immediately.  It will be necessary to exit the program, turn
  285. the meter off and back on again, and then restart OTVIEW to allow it
  286. to sync up with the meter at the new speed.
  287.  
  288. Mode: This value is used to tell the meter how to communicate with
  289. the computer that is connected to it on the data port.  The available
  290. options are 'RS-232', 'DTAMGR', 'DATA A', and 'DATA B'.  When using
  291. OTVIEW on your personal computer, this value should always be set to
  292. 'RS-232', Selecting any other value will cause the ONE TOUCH II to
  293. stop talking to your computer, and you will not be able to use OTVIEW
  294. until the meter has been configured back to 'RS-232'.  If this should
  295. accidentally happen, refer to the section on Troubleshooting to see
  296. how this may be done.
  297.  
  298.  
  299. 7.2    DOWNLOAD ONE TOUCH DATA
  300.  
  301. Once Communications has been established with the ONE TOUCH II, you
  302. may download the data currently stored in the meter's memory.  The
  303. program will display the number of readings received from  the meter
  304. as they are transmitted.  At this time the data is only stored in
  305. your PC's system memory and  has not yet been written to disk. The
  306. "Display ONE TOUCH data" menu will now be presented to you.  This
  307. menu will be discussed below.
  308.  
  309.  
  310. 7.3    READ STORED ONE TOUCH DATA
  311.  
  312. Selecting this option will display the names of previously-stored ONE
  313. TOUCH II data files  residing in the current directory. OTVIEW files
  314. can be identified by the 'DAT' extension in the  DOS file name.
  315. Highlight the one of interest with the arrow keys or mouse, and
  316. select it with  either the left mouse button or the Enter key. If the
  317. file selected is not a valid OTVIEW data file,  then an error message
  318. will be displayed.  After selection, the "Display ONE TOUCH data"
  319. screen  will then be presented.  This menu will be discussed below.
  320.  
  321.  
  322. 7.4    CLEAR ONE TOUCH MEMORY
  323.  
  324. As previously cautioned, this command will clear the ONE TOUCH II
  325. on-board memory.  It is only used when data readings have been saved
  326. to a disk file and you wish to start a "fresh" sequence of readings
  327. in the meter.  This is done to prevent duplicate readings from being
  328. stored in a concatenated (sequentially added) data file.  It may take
  329. as long as 10 to 20 seconds for this operation to complete.  BE
  330. CAREFUL WITH THIS COMMAND. DATA IS IRRETRIEVABLE !
  331.  
  332.  
  333. 7.5    UPDATE PATIENT NAME
  334.  
  335. The data file saved to disk can be customized with the patient's name
  336. and/or other Identification.  Use This command and entry field to
  337. enter the designated patient's name or ID.  This entry will be
  338. written back into the OTVIEW program file, so it is only necessary to
  339. enter this information once.
  340.  
  341.         
  342. 7.6    EXIT PROGRAM
  343.  
  344. Terminates the program's execution and returns you to DOS.
  345.  
  346.  
  347. 8    THE 'DISPLAY ONE TOUCH DATA' MENU
  348.  
  349.     This menu gives you the following choices:
  350.  
  351.             Display ONE TOUCH data
  352.             Print ONE TOUCH data
  353.             Plot ONE TOUCH data
  354.             Save ONE TOUCH data to disk 
  355.             Return to main menu
  356.  
  357.     
  358. 8.1    DISPLAY ONE TOUCH DATA
  359.         
  360. This selection will present you with a very detailed summary of the
  361. ONE TOUCH II data downloaded from the meter or read from the disk
  362. file. The display is titled with the name of the currently-loaded
  363. data file, and shows a header containing the date and time from the
  364. meter of when the most recent download was performed, as well as the
  365. name or ID of the patient. In addition, the ONE TOUCH II Units
  366. setting, Minimum and Maximum Check Values, and Serial number are
  367. displayed as read directly from the meter. Minimum, Maximum and
  368. Average blood glucose values are calculated and displayed at the top
  369. of the screen.
  370.  
  371. The rest of the display contains a line for each individual data
  372. entry read from the meter.  Readings are sorted by date and time,
  373. with the most recent entries first and the oldest last.  Each entry
  374. includes the day, date, and time the reading was taken, the actual
  375. blood glucose value in the appropriate units, and the event number
  376. you may have entered for the reading (or zero for default).  If a
  377. sample was taken that was measured as off scale high, the program
  378. will substitute a value of 600 MG/DL (or 33.3 MMOL/L) for that entry.
  379. Also displayed is a 'FLAGS' field for each line.  If an entry is
  380. marked as a check or control reading by the meter, then a 'CHK' or
  381. 'CON' flag will appear in this field, respectively.  For each entry,
  382. the ONE TOUCH II contains error checking information to ensure that
  383. the data contained in its memory has not been corrupted in some way.
  384. If the meter has declared a reading as invalid, or an error was
  385. detected by OTVIEW when it was downloaded from the meter, then an
  386. 'INV' indicator will appear in the flags field.  Entries marked as
  387. check, control, or invalid are not included in minimum, maximum, or
  388. average value calculations.
  389.  
  390. To the right of the screen is an area where you can record notes and
  391. comments for each entry.  Examples of how this feature may be used
  392. can be seen in the example included in this document and in the
  393. sample file OTSAMPLE included with the program.  As with the other
  394. menus, either the mouse or the cursor keys may be used to scroll
  395. through the data.  The screen may be scrolled up and down by
  396. positioning the mouse cursor in the header or in the bottom line
  397. respectively and pressing the left button, or you may use the up and
  398. down cursor keys to scroll one line at a time, or page up/page down
  399. to scroll one screen at a time.  The 'Home' key will put you on the
  400. first reading in the file, and 'End' will bounce you to the last
  401. entry.  A pair of blinking brackets will be displayed around the
  402. reading on the row where the cursor is currently positioned in order
  403. to help you line up your comments with the appropriate entry.
  404.  
  405. The cursor key can be positioned anywhere on the screen for entering
  406. notes by pressing the left mouse button or the cursor keys.  When
  407. entering comments from the keyboard, the left cursor, right cursor,
  408. insert, delete, backspace, and enter keys function just like a normal
  409. text editor.  Note that the 'Notes' field is the only portion of the
  410. data file that the program will allow the user to modify directly.
  411. In order to ensure accuracy and integrity of the data, OTVIEW will
  412. not make or allow any changes to any other fields in the readings.
  413.     
  414. Please keep in mind that when viewing or making notes on data that
  415. has just been downloaded from the meter (identified by the title
  416. 'Display Download Data' at the top of the screen), the entries are
  417. still in the computer memory and has NOT been saved to a disk file
  418. yet.  To do this, you must select 'Save ONE TOUCH Data to Disk' (see
  419. below).  If you attempt to exit the program without first saving the
  420. data to disk, the program will display a warning asking if you first
  421. wish to do this before you exit.  If you decide to terminate OTVIEW
  422. anyway, the data (and notes you have made) will be lost and must be
  423. downloaded again.
  424.  
  425. Note: Some of the newer version of the ONE TOUCH II meter now
  426. calculate and display the average value for blood glucose reading.
  427. This number may be different than that calculated by OTVIEW in that
  428. the meter maintains an incremental average (that is, each new reading
  429. is averaged in with the previous value to form a new average) whereas
  430. OTVIEW computes a new value from scratch based on each individual
  431. reading.  The program also does not include readings that are marked
  432. as check, control, or invalid.  So although the actual numbers may be
  433. different, the average value calculated by OTVIEW is considered to be
  434. more accurate than the one given by the meter.
  435.  
  436.  
  437. 8.2    PRINT ONE TOUCH DATA
  438.  
  439. This selection will print out all the information shown in the above
  440. display to the default printer, including the file name, patient
  441. name, and any annotations made in the entries. There can be up to 250
  442. readings, so allow sufficient paper for the print-out!  (This feature
  443. has been disabled in the demonstration version OTDEMO).
  444.  
  445.  
  446. 8.3    PLOT ONE TOUCH DATA
  447.  
  448. This selection will display a sub-menu that will allow you to enter
  449. the starting and ending dates for the ONE TOUCH II data currently in
  450. memory that you wish to plot.  These default to the dates of the
  451. earliest and latest readings, and follow whatever date format is used
  452. in the entries (M/D/Y or D/M/Y).  The second sub-menu will show how
  453. many readings were found within the specified date interval (or an
  454. error message if none were found), and will also allow you to set the
  455. high and low limit for the vertical axis of the plot.  These will
  456. default to the highest and lowest values found within the date
  457. interval, and will be in whatever units were specified in the file.
  458. As stated above, values flagged as check, control, or invalid are not
  459. considered valid entries for plotting. After entering these limits,
  460. the plot will be displayed on the screen until any key or mouse
  461. button is pressed. The patient's name, data file name, and units will
  462. be displayed at the top of the screen. Exiting from the plot will
  463. return you to the value limit and date range submenus sequentially.
  464.  
  465. If you have an IBM compatible graphics printer connected to your PC,
  466. a hard copy of the plot may be printed by using the DOS utility
  467. GRAPHICS.COM.  Simply load the GRAPHICS.COM program before starting
  468. OTVIEW, and when the plot is displayed on the screen, press the
  469. 'Print Screen' key.  Refer to your DOS reference manual for more
  470. information on GRAPHICS.COM.
  471.     
  472. After much experimentation, it was determined that a minimum screen
  473. resolution of 640x348 is necessary to display a graph that is
  474. legible.  This means that the plot function cannot be used if you
  475. have one of the older Color Graphic Adapter (CGA) cards since their
  476. maximum resolution is 640x200.  The OTVIEW plot function has been
  477. successfully tested on VGA, EGA, MCGA, Hercules, AT&T, and IBM 8514
  478. type graphic adapters with an appropriate monitor.  If a suitable
  479. adapter is not detected, or it cannot be switched to a video mode of
  480. acceptable resolution, then this function will display an error
  481. message.
  482.  
  483. One thing to keep in mind as you are analyzing these graphs is that
  484. the horizontal axis is normalized with respect to the relative time
  485. the readings were taken, not an absolute time scale.  In other words,
  486. the individual readings are plotted in an even, linear spacing, and
  487. the date scale on the horizontal axis is labeled according to the
  488. time of the corresponding data values, and not the other way around.
  489. If you take the same number of readings every day on a consistent
  490. basis (more or less), then this should not present a problem.
  491. However, if there are wide gaps in time between groups of readings,
  492. or they are 'bunched up' in one or more ranges of dates, then the
  493. graph may not necessarily display an accurate portrayal of your blood
  494. glucose level throughout a continuous, linear time frame. 
  495.  
  496. If you plan to print out and maintain a record or archive of the
  497. plots for different time periods, then one tip we have found useful
  498. is to use the same date range (i.e. 2 weeks, one month, etc.) and
  499. value limits for each plot.  This makes it much more easy to compare
  500. separate plots with one another, and allows you to lay graphs out
  501. side by side and see a pictorial representation of your blood glucose
  502. level over a long period of time.
  503.  
  504.  
  505. 8.4    SAVE ONE TOUCH DATA TO DISK
  506.  
  507. This selection will allow you to save the current data (including
  508. annotations) to disk file. A default name of 'OTmmddyy' (or
  509. 'OTddmmyy' depending on the date format selected) is already entered
  510. for you, but you can use any legal eight character DOS file name that
  511. you wish.  As stated above, all ONE TOUCH II data files use a file
  512. extension of '.DAT', and they are stored in whatever the current
  513. default directory was when you started OTVIEW.  If a file by that
  514. name already exists, then a warning message is displayed and you are
  515. prompted to either overwrite the existing disk file, or chose another
  516. name.  Error messages will also be displayed for any other disk error
  517. detected during the save (Drive Not Ready, Drive Write Protected, Not
  518. Enough Room, etc.).
  519.  
  520. One advantage of OTVIEW is that the data is stored as a standard text
  521. file in exactly the same format in which you see it printed or
  522. displayed on the screen, rather than in some binary or non-printable
  523. form such as a data base file or word processor file.  This means
  524. that the OTVIEW data file can be copied or uploaded to any other
  525. computer at a doctor's office or hospital, or even fed into a FAX
  526. modem for transmission to your medical facility.  Everything that
  527. your doctor needs to examine your blood glucose level performance is
  528. included in this file: Patient name, dates and times, overall
  529. statistics, and individual readings.  Data files may also be brought
  530. up under a standard word processor for review and editing.  In
  531. addition, a separate utility is also under development which will
  532. convert OTVIEW data files into comma delimited format (CDL) files, so
  533. that this information may be imported directly into many commercial
  534. spreadsheet and data base applications, allowing for more elaborate
  535. graphing, plotting, and statistical analysis to be performed.  This
  536. utility will be distributed in the near future to registered OTVIEW
  537. users at no charge.
  538.  
  539. Also note that the save function is not available in the
  540. demonstration version OTDEMO.
  541.  
  542.  
  543. 8.5    APPEND DATA TO DISK FILE
  544.     
  545. Once you have downloaded a set of readings from the ONE TOUCH II, the
  546. Append option will be displayed in order to allow you to add the new
  547. readings into an already existing data file.  Just select which disk
  548. file you wish to append the data to, and if it is a valid OTVIEW data
  549. file, the program will insert the new data into it and tell you how
  550. many new readings have been added.  You may then review the data and
  551. add notes, or print or plot the information, but as stated above, the
  552. updated entries are not automatically saved to disk.  You must do
  553. this yourself when you are finished, and if you attempt to exit the
  554. program without first saving it, OTVIEW will display a prompt
  555. reminding you to do this before terminating the program.
  556.  
  557. As previously mentioned, entries in the data files are stored with
  558. the most recent reading first and the oldest ones last.  When you
  559. tell OTVIEW to append to add new readings to a data file, the program
  560. reads the date and time of the most recent entry in the file, and
  561. then scans the downloaded values to determine if any of them are
  562. newer than this.  If no new entries are detected, an error message
  563. will be displayed, otherwise OTVIEW will show you the number of new
  564. entries added to the beginning of the file.  Values downloaded from
  565. the meter with a date and time tag older than the most recent entry
  566. in the file will not be saved, in order that an accurate ordering of
  567. entries by date and time can be preserved.  For this to be possible,
  568. it is necessary that the meter settings for blood glucose units, date
  569. format, and time format must match those of the data file to which
  570. the new readings will be appended.  If not, an error message stating
  571. that configuration parameters do not match those in the data file
  572. will be displayed.
  573.  
  574. New readings may be added to a data file until it reaches a maximum
  575. size of 250 entries.  If the file is already this full, then a disk
  576. file full error message will be shown.  In addition, if there is not
  577. enough room in the data file to store all the newly downloaded
  578. readings, then a message will be displayed asking if you would like
  579. for OTVIEW to save only the oldest of the newly downloaded readings
  580. up to the maximum disk file size of 250, or if you want to abort the
  581. operation and create a new disk file.  From actual experience, it has
  582. been determined that this limit of 250 entries does not really
  583. present that much of a problem.  Data files much larger than this
  584. begin to become awkward when trying to review and analyze the
  585. readings, and inconvenient to print or plot.  A typical scenario is
  586. to have one data file per month, and add the new readings to it every
  587. five to seven days.  At this rate, data files can handle over eight
  588. readings per day, which should be more than sufficient !
  589.  
  590. When an append operation is performed, the summary information in the
  591. file header will also be updated.  The date, time, serial number, and
  592. minimum and maximum check strip values will be modified to reflect
  593. the most recent values of these parameters received from the meter.
  594. The patient name will also be updated if it has been changed since
  595. the file was originally created or last appended.  In addition, new
  596. values for minimum, maximum, and average values will be calculated
  597. based on all readings now in the file.
  598.  
  599. If the append operation has successfully added all new readings to
  600. the disk file, then the user will be asked if he wants to clear the
  601. meters memory upon exiting the program.  It is your decision whether
  602. or not to maintain old readings in the meter after they have been
  603. saved to a disk file.  However, previous experience has shown that it
  604. is much easier and more convenient to review, manipulate, and
  605. communicate information obtained from the meter when it is saved as
  606. text in a disk file rather than being kept in the meter, where you
  607. must manually scroll through every value for each reading one at a
  608. time.  The data is also much more secure since backup copies of the
  609. data files can easily be made.  It should not be necessary to remind
  610. you to always keep backup of all your data files, preferably on
  611. floppy disks !
  612.  
  613.  
  614. 8.6    RETURN TO MAIN MENU
  615.  
  616. When you are finished with these functions, this selection will
  617. return you to the main OTVIEW menu.  If you have downloaded data from
  618. the meter and have not yet saved or appended it to a disk file, the
  619. program will ask you whether or not you want to save the data before
  620. exiting this screen.
  621.  
  622.  
  623. 9    TROUBLESHOOTING
  624.  
  625. OTVIEW is designed to be a simple, easy to use tool that should take
  626. very little time in order to become acquainted with how it operates.
  627. The prompts and messages are self explanatory, and when used per the
  628. directions and guidelines as outlined in this document, you should
  629. have little or no trouble in running the program.  The only area
  630. which may appear to be a bit tricky is getting the meter to talk
  631. correctly to your computer.  We have included here a few tips we have
  632. picked up in our experiences with developing this software, and they
  633. should help you to resolve any problems which you might encounter.
  634.  
  635. When using this program with your ONE TOUCH II meter on a daily
  636. basis, it is not uncommon to receive an occasional Time-out or
  637. Checksum error.  This is particularly true when sending a number of
  638. different commands to the meter such as when you are configuring
  639. multiple operating parameters, and is also commonly seen when
  640. clearing the meter's memory.  Whenever you have different computers
  641. executing different software at different speeds and trying to talk
  642. to each other in a spontaneous manner, communications problems are
  643. almost certain to be seen.  Normally this does not mean that there is
  644. any problem with either the meter or your computer.  Commands sent to
  645. the meter which result in errors are automatically retried several
  646. times by OTVIEW before an error message is displayed.  If a Checksum
  647. or Time-out error message is presented, just make sure that the meter
  648. is still on and flashing "INSERT STRIP", and press enter to retry the
  649. operation.  The ONE TOUCH II meter has a built in timer, so if it is
  650. turned on and not used (or if no communications through the data port
  651. are detected), it will automatically turn itself off after about one
  652. minute.
  653.  
  654. If your are unable to establish communications with the meter at all,
  655. there may be several possible reasons.  Make sure that the connectors
  656. on each end are inserted tight, and the 25 pin connector on the
  657. computer end should be screwed down into its socket.  Make sure you
  658. are plugged into the correct serial port, not a parallel port by
  659. mistake, and that this matches the port number that you are selecting
  660. on the OTVIEW menu.  If you still have problems, then try a different
  661. serial port, or better yet a port on a different computer, if you
  662. have access to one.  To verify that there is no trouble with the
  663. OTVIEW program itself, try communicating with the meter using a
  664. standard terminal program, such as Procomm.  Configure it for the
  665. correct serial port and baud rate, 8 bits, no parity, and flow
  666. control off.  When you turn the meter on, a line should be displayed
  667. showing the current values for the operating parameters, and then
  668. continuous 'INSERT' 'STRIP' messages will be received.  If you type
  669. in the command 'DMP', the readings from the meter's memory should be
  670. displayed on the screen.
  671.  
  672. In the event that there is still no data seen from the meter, the
  673. reason might be that it is configured to use a data communications
  674. mode other than RS-232.  To check for this and to set this parameter
  675. to RS-232 if it is not already, follow these steps:
  676.  
  677.     1.    Turn the meter off.
  678.     2.    Press and hold the 'M' (memory) button on the rear of 
  679.         the meter.
  680.     3.    Turn the meter on.
  681.     4.     Release the 'M' button. The value of the BEEP/NOBEEP 
  682.         parameter should now be
  683.         seen on the display.
  684.     5.    Press the 'M' button seven times to display the value 
  685.         of the Data Management Mode.
  686.     6.    If this does not show 'RS-232', press the 'C' (code) 
  687.         button until 'RS-232' is displayed.
  688.     7.    Turn the meter off.
  689.     8.     Start OTVIEW and attempt to establish communications 
  690.         with the meter.
  691.  
  692.  
  693. 10   COPYRIGHT INFORMATION
  694.  
  695. This program is being made available on an 'as is' basis, and carries
  696. no warranties express or implied.  The authors shall in no way be
  697. held liable for any damages resulting from the use of this program or
  698. the media on which it is distributed, including, without limitation,
  699. misrepresentation of data, loss of information, damage to equipment,
  700. or any other incidental or consequential damages.
  701.  
  702. Neither the authors, nor Merritt Island Technologies, Incorporated,
  703. nor the SPACECON BBS are affiliated with LifeScan, Inc., or Johnson
  704. and Johnson, Inc.. One Touch II (r) is a registered trademark of
  705. LifeScan, Inc.  MS-DOS, and Windows are registered trademarks of
  706. Microsoft Corporation.  OS/2 is a registered trademark of IBM Corp.
  707. OTVIEW, OT_VIEW, and OTDEMO are proprietary names for exclusive use by
  708. Merritt Island Technologies, Inc. of Merritt Island, Florida, USA.
  709.  
  710.  
  711. 11    SAMPLE OUTPUT
  712.  
  713. This is the format of the output from OTVIEW taken from a set of
  714. actual blood glucose readings.  The data file OTSAMPLE included with
  715. this program also shows what the screen and data file formats look
  716. like.
  717.  
  718.  
  719.   DATE:  8/30/93   TIME: 11:56:00 PM   NAME: Jane Doe                 
  720.   UNITS: MG/DL     CHK MIN:  73     CHK MAX:  98     SER NO: CHS0196AA
  721.            MIN VAL:  31     MAX VAL:  405    AVG VAL:  126 
  722.  
  723. DAY    DATE       TIME      VALUE  EVENT   FLAGS          NOTES
  724. ---    ----       ----      -----  -----  -------  --------------------
  725. TUE   4/20/93   9:23:00 PM    81     0    CHK                          
  726. TUE   4/20/93   9:22:00 PM    31     0                                 
  727. TUE   4/20/93   9:21:00 PM    81     0    CON                          
  728. SUN   4/18/93   1:20:00 PM    59     0                                 
  729. SUN   4/18/93   9:36:00 AM   172     0                                 
  730. SAT   4/17/93   8:51:00 PM   211     0             Ate Dessert          
  731. SAT   4/17/93   3:24:00 PM    46     0                                 
  732. SAT   4/17/93  12:50:00 PM   222     0                                 
  733. SAT   4/17/93   8:58:00 AM    53     0             Fasting             
  734. SAT   4/17/93   1:41:00 AM   101     0                                 
  735. SAT   4/17/93   1:13:00 AM    31     0    CHK                          
  736. FRI   4/16/93  10:05:00 PM   202     0                                 
  737. FRI   4/16/93   9:00:00 PM   405     0             Infusion set bad     
  738. FRI   4/16/93   1:12:00 PM    65     0                                 
  739. FRI   4/16/93  11:07:00 AM    56     0                                 
  740. FRI   4/16/93   6:44:00 AM    60     0             Still feel bad      
  741. THU   4/15/93   9:18:00 PM   194     0                                 
  742. THU   4/15/93   2:56:00 PM    53     0                                 
  743. THU   4/15/93  10:27:00 AM    55     0    CON                          
  744. THU   4/15/93   6:38:00 AM    92     0                                 
  745. WED   4/14/93   8:33:00 PM   143     0                                 
  746. WED   4/14/93   3:15:00 PM    51     0                                 
  747. WED   4/14/93   1:50:00 PM    58     0             After Lunch         
  748. WED   4/14/93  11:25:00 AM   228     0                                 
  749. WED   4/14/93   6:49:00 AM    49     0             Before Breakfast    
  750. TUE   4/13/93   9:25:00 PM   209     0                                 
  751. TUE   4/13/93   4:28:00 PM    70     0                                 
  752. TUE   4/13/93   1:31:00 PM   114     0                                 
  753. TUE   4/13/93  10:47:00 AM    58     0             After Exercise      
  754. TUE   4/13/93   8:24:00 AM    60     0                                 
  755. TUE   4/13/93   6:54:00 AM   147     0                                 
  756. MON   4/12/93   8:17:00 PM   176     0                                 
  757. MON   4/12/93   3:04:00 PM   104     0                                 
  758. MON   4/12/93  10:58:00 AM    45     0                                 
  759. MON   4/12/93   6:23:00 AM   258     0             stressed out at work
  760. SUN   4/11/93   8:20:00 PM    90     0                                 
  761. SUN   4/11/93   5:09:00 PM    23     0                                 
  762. SUN   4/11/93   1:59:00 PM    78     0                                 
  763. SUN   4/11/93  12:52:00 PM    44     0                                 
  764. SUN   4/11/93   9:45:00 AM   108     0             skipped breakfast   
  765. SAT   4/10/93   7:27:00 PM   125     0                                 
  766.                         - END OF SAMPLE EXTRACT -
  767.  
  768. -EOF-